feat: bring the vland templates to the org standard, and fix vland init's git identity and hooks - #271

Summary

The vland templates get the org standard (brand, dx, env, theme-toggle, www), plus two vland init fixes. Today a generated project can't even install: @rrlab/cli@^0.1.0 doesn't exist.

 vland/templates/{library,backend,monorepo}/
-├── .node-version
 ├── mise.toml            # + min_version 2026.9.16, pnpm 10.30.3, [settings] lockfile = true
+├── mise.lock            # node 24.21.0 + pnpm 10.30.3, 7 platforms, lockfile revision 3
+├── pnpm-workspace.yaml  # release-age cooldown, lefthook in onlyBuiltDependencies, sideEffectsCache: false
 ├── package.json         # @rrlab/cli ^1.3.4, changesets 3.0.3 + changelog-github 1.0.1, pnpm@10.30.3, engines node >=22.18.0
 ├── .changeset/config.json   # schema 4.0.1, format: false, commit: true, repo from visibility
 └── .github/workflows/
     ├── ci.yml           # checkout v7.0.1 (no credentials) → mise-action v4.3.0 → install --frozen-lockfile → rr check → test → build
+    ├── workflow-audit.yml   # zizmor 1.30.1
     └── release.yml      # library: changesets/action v2.1.2 as vland-bot (theme-toggle's job, minus previews)

engines.node goes to >=22.18.0, like the published packages in #272: rr loads run-run.config.mts with Node's type stripping, unflagged from 22.18.0. Every action is pinned by SHA, and dx's own workflow audit now runs zizmor from the repo root, which also covers vland/templates/*/.github/workflows (on main they have unpinned-uses, artipacked and excessive-permissions findings; here, none). The monorepo had no .github/; its new CI tests and builds with --affected against origin/main.

vland init (own commits, patch changesets):

 runInit
+  git init                        # before the install, so lefthook's postinstall finds the repo
   pnpm install
-  git init
   git add -A
-  GIT_AUTHOR_*/GIT_COMMITTER_* = vland <noreply@variable.land>   # outranked the user's git config
-  git commit
+  git -c user.name=vland …        # only for what `git config` can't resolve in the new repo
+  git commit --no-verify          # the hooks are for the user's commits, not the scaffold

Placeholders. The changelog repo comes from the visibility: withvariablelab/<name> for a public library, variableland/<name> for a private one and for every backend and monorepo. It was <name>/<name>, which theme-toggle had to fix by hand. The library README names the scoped package (pnpm add @variablelab/<name>).

Every generated file passes oxfmt and Biome, so rr check starts green with either plugin. oxfmt sorts package.json keys (vland now puts a private library's private after version, instead of at the end), aligns Markdown tables and wraps at 100 columns. Biome sorts imports. The READMEs say to narrow oxc to oxc({ only: ["lint", "format"] }), because oxc and ts both provide the type-check.

Why sideEffectsCache: false. Of these repos only dx has its git hooks installed. theme-toggle (generated by vland) and control have none, for three reasons:

1. pnpm 10 skips lefthook's postinstall unless lefthook is in onlyBuiltDependencies.
2. vland installed before git init.
3. With pnpm's side-effects cache on, a lefthook already built in the store (on any machine with dx cloned) skips its postinstall.

This PR fixes all three. The cost: every time pnpm (re)links a dependency with an allowed build script, it reruns that script. Today that's only lefthook (and biome in the monorepo), so it's negligible. It grows if a project allows heavy native builds.

From variableland/control:

mise.lock: shipped in the template, not generated at init, for now. Generating it at init is viable: mise lock takes ~1.5 s, writes all 7 platforms and, with mise 2026.10, locks only the project's tools (not global or parent ones). It would get a fresh node patch and a lock revision that matches the user's mise, with no min_version. Against it: init would need mise on PATH, a trust env for the new dir, and a fallback when mise is missing. I propose it as a follow-up.

Changesets. minor for the templates: vland init's interface doesn't change, but the generated project needs new things (mise ≥ 2026.9.16, the VLAND_BOT_CLIENT_ID variable and VLAND_BOT_PRIVATE_KEY secret) and behaves differently (pnpm changeset commits). The two init fixes are patch.

Evidence

• Before: vland init my-lib -t library → pnpm install → ERR_PNPM_NO_MATCHING_VERSION No matching version found for @rrlab/cli@^0.1.0. mise install --locked fails: there is no lock.
  After, each template generated with the local vland, under mise isolated from my global config (MISE_CONFIG_DIR/MISE_GLOBAL_CONFIG_FILE on an empty config):

  • mise install --locked installs node 24.21.0 and pnpm 10.30.3 into an empty MISE_DATA_DIR (macOS arm64; the linux-x64 entries come from mise's metadata, not a run);
  • pnpm install, the README's rr plugins add … --yes and rr jsc --fix (see Merge Danger), then rr check, pnpm test and rr pack (pnpm build in the monorepo) pass; pnpm test --affected works;
  • the backend's pnpm dev answers {"ok":true} on the port set in .env;
  • zizmor 1.30.1 with online audits: no findings. The one suppressed is theme-toggle's too (secrets-outside-env on the bot key, auditor persona);
  • git hooks installed in all 6 projects of the plugin matrix;
  • with fix: make rr plugins add work without a TTY and leave a project rr check passes #276's rr installed through pnpm overrides: in all 6 projects (library, backend and monorepo, each with biome or with oxc), every rr plugins add without --yes and without a TTY, then rr check, rr test, and rr pack or pnpm build, exit 0. In the monorepo that includes ts and tsdown per workspace, with apps/web on the inferred React preset.

• Tests (vland/cli/test/integration/), red on main, green here:

  init-templates  ×4  every file passes oxfmt and Biome (library, private library, backend, monorepo)
                  ×3  pins node and pnpm with mise and a lockfile
                  ×3  pins every workflow action by SHA and checks out without credentials
                  changelog repo: withvariablelab/<lib> | variableland/<private lib> | variableland/<mono>
  init-git        commits as the user's git identity     (old code: "vland <noreply@variable.land>")
                  falls back to the vland identity when git has none
                  runs git init before the install, and the first commit skips the hooks it set up
  

  The format test uses the dx workspace's oxfmt and Biome. A bump that changes their output makes it fail, and the fix is to reformat the templates.

  With my real git config, the init commit is mine and carries an SSH signature.

• Not verified: the backend's docker build (no daemon here), the release workflow end to end, and whether a private library's repo in variableland has vland-bot's variable and secret. That last one is an assumption.

Merge Danger

Door: two-way

Blast Radius: every vland init

vland downloads the templates from withvariablelab/dx#main on every init, so this reaches every installed vland the moment it merges, before any release. With the published vland 0.3.7, {{githubOwner}} and {{packageName}} stay literal in .changeset/config.json and the library README. Merge, then release vland in the same sitting.

Until #276 (it fixes rr plugins add) is released: without a TTY, rr plugins add biome|ts|tsdown needs --yes (otherwise it waits on a prompt and exits 13), and rr check fails after rr plugins add biome until rr jsc --fix. The READMEs already tell agents to pass --yes.

Out of scope, for later: the monorepo has changesets but no release path, and the ts plugin rewrites @types/node to >=20.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Tj9MBgi2cQcRxSD9uikx6k